Clean fix — using @JsonCreator with DELEGATING mode is the right approach here, and I like that you kept the object form working too. Test coverage for both string and object query formats is great. Looks good to me.

关于 CI 失败原因的说明（下游使用方反馈）

我们在 RuoYi 侧集成 agentscope-extensions-rag-dify 时跟进了本 PR / #1917。

结论

• 本 PR 的 Dify 修复本身看起来没问题（Query.fromString + @JsonCreator(DELEGATING)，兼容 string / object 两种 query 形态，与我们本地 shadow 方案一致）。
• 当前 CI 红灯不是 rag-dify 模块测试失败，而是全仓流水线里无关的 flaky / 环境问题导致 build (ubuntu-latest) 失败，Windows 随之 cancelled。

我们核对到的失败点

1. 较新的 run（如 28213304132）

• 模块：agentscope-core
• 用例：SubAgentToolTimeoutRetryIntegrationTest.oldAgentIsStopped
• 断言：Expected exactly 1 tool invocation, got 0
• 与 DifyResponse / rag-dify 无关

2. 较早的 run（如 28181432978）

• 模块：agentscope-harness
• 用例：HarnessAgentTest.runtimeContextNullInputGetsDefaultSessionAndSandbox
• 错误：Failed to close extension context / 删除 /tmp/junit-... 临时目录失败（DirectoryNotEmptyException）
• 同样与 Dify 补丁 无关

影响

• Issue [Bug] Dify Cloud 检索接口 query 字段返回字符串，导致 DifyResponse 反序列化失败（kb_search 对 api.dify.ai 引用恒为空） #1917 与本 PR 仍 OPEN，未合入 main。
• Maven Central 正式版 2.0.0 GA（2026-07-10）的 jar 内 DifyResponse$Query 仍没有 string @JsonCreator。
• 下游目前只能继续用同包名 class shadow 兜底，才能对接真实 api.dify.ai。

建议

1. 对本 PR 做一次 re-run，或 rebase 到最新 main 后再跑 CI。
2. 若上述 core/harness 用例仍 flaky，建议与本 PR 解耦（单独修 flaky / 临时排除），避免阻断这个对 Dify Cloud 很关键的兼容性修复。
3. 合并后请尽早发包含该修复的正式版（或至少 SNAPSHOT 可验证），方便下游去掉 shadow。

感谢维护！本评论仅作下游排查反馈，无催促之意。